home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Development / Source / MacGS 2.5.2ß3 Dev ƒ / READ_ME < prev    next >
Text File  |  1993-04-17  |  10KB  |  233 lines
  1. 17 April 1993
  2.  
  3. Overview
  4. --------
  5. MacGS_2.5.2b3_Runtime.cpt contains a self-contained runtime environment
  6. for version 2.5.2 Beta 3 of Macintosh Ghostscript that runs on a
  7. Macintosh with at least 2 Megabytes of memory.
  8.  
  9. MacGS_2.5.2b3_RT_No_Fonts.cpt is identical to MacGS_2.5.2b3_Runtime.cpt
  10. except it does *not* contain the Ghostscript fonts.  This file was
  11. specifically created for those who are upgrading from a previous version
  12. of MacGS 2.5.x and who wish to avoid the cost of transferring
  13. Ghostscript's fonts.  Please do *not* obtain this archive unless you are
  14. upgrading from a previous version of MacGS 2.5.x.
  15.  
  16. MacGS_2.5.2b3_Dev.cpt contains the development environment for version
  17. 2.5.2 Beta 3 of Macintosh Ghostscript.  Because it does *not* contain
  18. all of the Ghostscript fonts, you must also obtain and unarchive
  19. MacGS_2.5.2b3_Runtime.cpt to obtain a complete Ghostscript runtime
  20. environment.  However, this archive contains sufficient files to run
  21. standalone.
  22.  
  23. This implemention does *not* require 32-bit Color QuickDraw and runs
  24. under both System 6 and System 7.  It should even run on black-and-
  25. white displays.
  26.  
  27. This version does *not* presuppose a 68020 or better processor, nor does
  28. it presuppose the existence of a 68881 FPU.  Although the FPU version
  29. is 20% faster, I felt that it was more important to distribute versions
  30. without this hardware requirement.  (As always, you can alwaus build an
  31. FPU version from the MacGS development distribution.)
  32.  
  33.  
  34. Getting Started
  35. ------- -------
  36. Once Ghostscript is initialized, use the MacGS menu item Open File... to
  37. select a file to preview.  I suggest your opening one of the files in
  38. gs:(Tests).  Also note that most of the files in the (macGS Tests)
  39. folder assume that the Laserprep file was previously loaded.  Use the
  40. MacGS menu item Resume to continue.
  41.  
  42. Because MacGS used hardcoded relative paths, I *strongly* suggest that
  43. you neither rename nor move files contained within the MacGS folder.  If
  44. you do, you risk of having MacGS fail during initialization and
  45. prematurely terminating.
  46.  
  47.  
  48. Mac-Specific Features
  49. ------------ --------
  50. Once Ghostscript is initialized, you can open and display PostScript
  51. files via the MacGS menu.  This menu also allows you to save your
  52. PostScript output as a PICT file.
  53.  
  54. You can Cut and Copy the rendered image to the clipboard.
  55.  
  56. The arrow keys will scroll the graphics window.  On an extended
  57. keyboard, the Page Up/Down and Home/End keys will scroll the image
  58. appropriately; the addition of the Option key alternatively specifies
  59. the horizontal scrollbar.
  60.  
  61.  
  62. Beta 3 Enhancements and Bug Fixes
  63. ---- - ------------ --- --- -----
  64. Because MacGS now correctly responds to page size and resolution changes
  65. specified via the GS' putdeviceprops operator (see language.doc), it
  66. will also change the size of its displayable area to match the paper
  67. sizes specified in gs_statd.ps.  Also, the file 300dpi.ps, located in
  68. (macGS Tests), shows how to change the displayed output resolution to
  69. 300 dpi.
  70.  
  71. MacGS will open PS files of type 'EPSF' as well as those of type 'TEXT'.
  72.  
  73.  
  74. Beta 2 Enhancements
  75. ---- - ------------
  76. The MacGS menu is now immediately available without having to bring the
  77. Graphics Window frontmost.  The command-key equivalents of the MacGS
  78. menu items are also honored.  (This entailed selectively pre-empting
  79. THINK C's console driver *without* changing any of Symantec's code.)
  80. As there have been reports of menu problems with Beta 1, these changes
  81. may ameliorate those problems.
  82.  
  83. You may now select alternative device drivers via MacGS' Configure...
  84. menu item.  In the near future (RSN :-), I'll look into providing a GUI
  85. to allow you to specify device-specific attributes.  Please note that
  86. most of the other drivers (viz., GIF and PBMPlus) create scratch files,
  87. some which need to be deleted and others which need to be renamed.
  88. However, this behavior seems to be a consequence of how these drivers
  89. were originally implemented.
  90.  
  91. You may interactively select a region to save to a file or copy to the
  92. clipboard.  Although this feature has been successfully tested with
  93. escher.ps, tiger.ps, and golfer.ps with a 2 Mbyte memory partition,
  94. depending upon the complexity of your image, you may need to increase
  95. MacGS' memory size.
  96.  
  97. When MacGS is rendering via the Open File... menu item, the cursor is
  98. changed to a spinning watch.
  99.  
  100. Under System 7, background processes are now given cycles.
  101.  
  102. showpage always requires the use of MacGS' Resume menu item.
  103.  
  104. If PICT recording runs out of memory, MacGS returns VMError.
  105.  
  106. To accommodate MacGS and intialization file interdependencies,
  107. gs_mac.ps checks MacGS' version.
  108.  
  109.  
  110. Beta 1 Enhancements and Bug Fixes
  111. ---- - ------------ --- --- -----
  112. You may now interrupt the execution of a large PS file by invoking Stop
  113. from the MacGS menu when GS pauses at the end of a page after a
  114. showpage.
  115.  
  116. The name of the Laserprep file has been moved from MacGS' resource file
  117. to the gs_mac.ps initialization file.
  118.  
  119. Runtime errors sometimes caused MacGS to terminate abnormally with a
  120. typecheck error if the Ghostscript interpretor was implicitly invoked
  121. via the Open File... menu item (-- matmesh2.ps did this).  This was
  122. caused by PS programs which did not restore the operand and dictionary
  123. stacks to their previous non-empty states.  The .macrunfile procedure in
  124. gs_mac.ps has been modified to accommodate this ... *antisocial*
  125. behavior.
  126.  
  127. In Beta zero, the Open File... command did not work the very first time
  128. it was used.
  129.  
  130.  
  131. Limitations (Caveat emptor!)
  132. ----------- ------- --------
  133. Both BeHierarchic and MenuChoice conflict with MacGS.  Because most of
  134. MacGS' GUI is implemented as a device driver, and because both of these
  135. INITs patch menu-related traps and don't necessarily restore the current
  136. resource file context, I strongly suggest that you not install these
  137. INITs when running MacGS.  (For you Mac hackers, the reason that MacGS'
  138. GUI is implemented as a device driver is because THINK C's *unmodified*
  139. stdio routines are implicitly running MacGS' event loop -- talk about
  140. tails wagging dogs!  Thus, MacGS is *unable* to save and restore the
  141. resource file context because it *never* calls MenuSelect ().)
  142.  
  143. There is no way to gracefully interrupt MacGS while it is rendering.
  144. Although I've implemented preliminary code (-- MacGS actually detects
  145. Command-. key presses), this feature relies on GS using the return value
  146. from gp_check_interrupts ().  Peter says that this is on his list of
  147. things to fix for GS 2.6.
  148.  
  149. MacGS 2.5.2 is *absymally* slow when rendering snowflak.ps.  This is
  150. because Peter eliminated the use of driver-specific fill trapezoid
  151. routines.  (MacGS *2.2* is actually very much faster.  Oh, well -- one
  152. step forward, two steps back....)  Peter's suggestion is to create an
  153. image device and let Ghostscript do the rendering.  However, the
  154. tradeoff is that a resultant picture is comprised of a monolithic bitmap
  155. and not composite, and editable, QD picture elements.
  156.  
  157. Printing appears to work for LaserWriters and DeskWriters.  However,
  158. because MacGS is printing a backing-store QD picture, the resolution is
  159. limited to 72 dpi (the Macintosh screen density).  In order to
  160. accommodate laserprinter resolutions (e.g., 300 dpi or whatever), MacGS
  161. would need to re-render the image at a higher resolution.  This is better
  162. done with a dedicated (TBD) MacGS printer driver.
  163.  
  164.  
  165. Bugs
  166. ----
  167. On a black-and-white (viz., 1-bit deep) display, some PS files make the
  168. initial contents of the graphics window black; scrolling the window
  169. sometimes ameliorates this problem.
  170.  
  171. There is a problem with GS 2.5.2 (which MacGS inherits) rendering
  172. screen.ps.  Peter is fixing this in GS 2.6.
  173.  
  174. There have been reports of INIT/cdev conflicts (Menubar Pattern, Window
  175. Shade, MenuChoice, and BeHierarchic).  If you suspect that MacGS is
  176. failing because of an INIT conflict, please drop me a note indicating the
  177. suspect extension.  If the extension is either freeware or shareware,
  178. please indicate its availability and I'll attempt to obtain a copy for
  179. testing.
  180.  
  181. MacGS appears to suffer from memory lossage.  Symptoms include partial
  182. rendering to the screen, lack of backing-store, etc..  If this occurs,
  183. quit and restart MacGS.  If this problem persists, increase MacGS'
  184. memory size.  If it still persists, please drop me a note.
  185.  
  186.  
  187. THINK C Configuration Issues
  188. ----- - ------------- ------
  189. Because THINK C's development environment only approximates a unix
  190. system, you need to create an empty file named "sys/types.h" and put it
  191. in THINK C's system header file path (viz., where THINK C searches for
  192. "<.h>" files).  In addition, you'll need to create an alias (-- or a
  193. copy, for those of you still using System 6) of stdlib.h named
  194. "malloc.h" and also put it in THINK C's system header file path.
  195.  
  196.  
  197. Resource Hacking
  198. -------- -------
  199. I've created a 'pref' resource (the associated TMPL resource is
  200. included) that defines the size of the graphics output window.  If you
  201. want MacGS to use something other than your screen's maximum size,
  202. select the "Use resource" flag and change the resource's width and
  203. height fields.  Also, if you're both adventurous and curious, this
  204. resource contains additional fields whose values you may change for your
  205. runtime enjoyment.
  206.  
  207. You may also change MacGS' default paths by modifying the first string
  208. in the STR# 128 resource.  Caveat emptor!
  209.  
  210.  
  211. Potential Futures
  212. --------- -------
  213. An automatic printing driver.
  214.  
  215. Perhaps someone will be adventurous and create a PostScript-to-EPS
  216. driver using MacGS as a starting point.  :-)
  217.  
  218. Drag and drop preview/printing.
  219.  
  220. PAP level printing to PS printers.  Issues include what to do about
  221. missing fonts.
  222.  
  223.  
  224. Distribution Caveats
  225. ------------ -------
  226. Even though I've not necessarily included the caveat in all of MacGS'
  227. source code, the distribution of the source code is controlled by the
  228. GNU General License.
  229.  
  230.  
  231. ...Martin Fong                mwfong@nisc.sri.com
  232.  
  233.